From 2298c51d93c65ecb22080448213cdbc32d2e90ee Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Wed, 9 Nov 2011 22:08:43 -0500 Subject: [PATCH] Update documentation around deprecations. --- docs/reference/gtk/compiling.sgml | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/docs/reference/gtk/compiling.sgml b/docs/reference/gtk/compiling.sgml index b8a080d3bf..f4021c6ede 100644 --- a/docs/reference/gtk/compiling.sgml +++ b/docs/reference/gtk/compiling.sgml @@ -47,9 +47,20 @@ $ cc `pkg-config --cflags --libs gtk+-3.0` hello.c -o hello -If you want to make sure that your program doesn't use any deprecated -functions, you can define the preprocessor symbol GTK_DISABLE_DEPRECATED -by using the command line option -DGTK_DISABLE_DEPRECATED=1. +Deprecated GTK+ functions are annotated to make the compiler +emit warnings when they are used (e.g. with gcc, you need to use +the -Wdeprecated-declarations option). If these warnings are +problematic, they can be turned off by defining the preprocessor +symbol GDK_DISABLE_DEPRECATION_WARNINGS by using the commandline +option -DGDK_DISABLE_DEPRECATION_WARNINGS + + + +The older deprecation mechanism of hiding deprecated interfaces +entirely from the compiler by using the preprocessor symbol +GTK_DISABLE_DEPRECATED is still used for deprecated macros, +enumeration values, etc. To detect uses of these in your code, +use the commandline option -DGTK_DISABLE_DEPRECATED. There are similar symbols GDK_DISABLE_DEPRECATED, GDK_PIXBUF_DISABLE_DEPRECATED and G_DISABLE_DEPRECATED for GDK, GdkPixbuf and GLib. -- 2.30.2